======================================================
MPPWC v0.95: a Tracker Module Decoder for Winamp
Released: August 19, 2011
Author: Dios Gabor (Dege)
======================================================

1. Intro
--------

Recently I totally revamped my old music player originating
in the DOS era that was planned to be used for some demoscene
stuffs. Needless to mention that finally I (we) have never
released anything to any scene party, but the code was being
more or less maintained.
A few month ago I decided to port it to "thin" C++ and partly
assembly using modern things, just for fun. The evergreen pain
were the things missing in supporting of Impulse Tracker files
(>v2.0 with compressed samples, resonant filtering, and as I
looked around I found that many of new IT songs exist that use
stereo samples and a few unofficial additions to the IT format).
I think I've overcome most of them (wasn't easy to find info on
those since Jeffrey Lim never published that in his technical
descriptions as far as I know).

Altough creating a Winamp plugin was not the goal, but when
I finished I thought why not..


2. Features
-----------

So, MPPWC is an input plugin for Winamp to decode the following
tracker formats:

Amiga ProTracker (*.mod)
Composer 669	 (*.669)
MultiTracker	 (*.mtm)
Scream Tracker3  (*.s3m)
Fast Tracker 2	 (*.xm)
Impulse Tracker	 (*.it)

with true seeking during music playback.

About length detection of module playing time:
There are 2 choices:
- Disabling backward jumps: this option does not allow any loop
                            in the playback, you can listen
                            hidden parts of the song
                            (but not all of them if they are organized
                             unluckily..)
- Detect loop: when MPPWC detects the end of a loop, marks that
               point as the end of the song but MPPWC can be
               configured to repeat loops.


Ok, the config dialog is not too advanced and there is no fancy
file info dialog about instruments, samples and everything, but hey,
it is just a pre 1.0 version.


3. Requirements
---------------

Any x86 processor with SSE2 support (it is old enough to dare to
require it as a minimum).

Does 64 bit Winamp exist? I also have the x64 version of the decoder. :)


4. Installing MPPWC "by hand"
-----------------------------

Well, just copy in_mppwc.dll into your Winamp\Plugins folder then
restart Winamp and it should work.


5. Uninstalling MPPWC "by hand"
-----------------------------

Delete these files:

	Winamp\Plugins\in_mppwc.dll
	Winamp\Plugins\in_mppwc.cfg
	Winamp\in_mppwc.txt


6. Known issues
---------------

- MPPWC may not cooperate well with Winamp's built-in module decoder (in_mod.dll).
  I mean this can cause crashes as they support common file types.

- klisje.mod: MPPWC plays incorrectly slowly a part of the song, but I don't
              understand it because all docs say that param >= 32 of the
              "Set Speed" effect sets the BPM not the speed...
              Or is it true only for really old Amiga files and this command was
              misinterpreted in latter trackers, or what? Even win32 version of
	      Protracker plays it wrong.


7. Thanksto's
---------------

Thanks to Chris Benshoof for his mini crt, I built MPPWC using that great
stuff.
For more see: http://www.benshoof.org/blog/minicrt/


8. Change list
---------------

0.95:	- A serious bug of handling IT instrument envelopes is fixed
	- Fixing the usage of 'last nonzero effect parameter' in S3M's, it was buggy
	- Fixing the 'Retrig and Volume Slide' effect to match ST3, FT2 and IT
        - Effect 'Pattern Cycle' was also buggy, fixed
	- Resonant filter is slightly modified to match Impulse Tracker better
	- A bug in the mixer is fixed: it couldn't handle the over-amplficiation
          when large resonance values were used; amplification interval is widened
	- A bug in detecting loops is fixed (ehh.. uninitialized variable..)
        - Backward seeking could cause incorrent playing speed, fixed
        - Random memory content could be attached to the title of 669's, fixed
        - Option 'Strip ending empty patterns' is added to the config dialog
        - 'Volume amplification' is added to the config dialog
        - Font of the song message is changed to Courier New

0.94:	The original version


Enjoy!
	Dege
